home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / standard / ldgetname.z / ldgetname
Encoding:
Text File  |  2002-10-03  |  1.9 KB  |  48 lines
  1. LDGETNAME(3X)                                         Last changed: 11-5-98
  2.  
  3.  
  4. NNAAMMEE
  5.      llddggeettnnaammee - Retrieves symbol name for object file symbol table entry
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssttddiioo..hh>>
  9.      ##iinncclluuddee <<ffiilleehhddrr..hh>>
  10.      ##iinncclluuddee <<ssyymm..hh>>
  11.      ##iinncclluuddee <<llddffccnn..hh>>
  12.  
  13.      cchhaarr **llddggeettnnaammee (("_l_d_p_t_r,, ssyymmbbooll"")
  14.      LLDDFFIILLEE **_l_d_p_t_r;;
  15.      ppSSYYMMRR **_s_y_m_b_o_l;;
  16.  
  17. IIMMPPLLEEMMEENNTTAATTIIOONN
  18.      IRIX systems (o32 ABI only)
  19.  
  20. DDEESSCCRRIIPPTTIIOONN
  21.      llddggeettnnaammee returns a pointer to the name associated with _s_y_m_b_o_l as a
  22.      string.  The string is contained in a static buffer.  Because the
  23.      buffer can be overwritten by later calls to llddggeettnnaammee, the caller must
  24.      copy the buffer if the name is to be saved.
  25.  
  26.      If the name cannot be retrieved, llddggeettnnaammee returns NNUULLLL (defined in
  27.      <<ssttddiioo..hh>>) for an object file.  This occurs when:
  28.  
  29.      * The string table cannot be found.
  30.  
  31.      * The name's offset into the string table is beyond the end of the
  32.        string table
  33.  
  34.      Typically, llddggeettnnaammee is called immediately after a successful call to
  35.      llddttbbrreeaadd.  llddggeettnnaammee retrieves the name associated with the symbol
  36.      table entry filled by llddttbbrreeaadd.
  37.  
  38.      The program must be loaded with the object file access routine
  39.      library, lliibbmmlldd..aa.
  40.  
  41. SSEEEE AALLSSOO
  42.      llddcclloossee(3X), llddooppeenn(3X), llddttbbsseeeekk(3X), llddttbbrreeaadd(3X)
  43.  
  44.      llddffccnn(4)
  45.  
  46.      This man page is available only online.
  47.  
  48.